Skip to content

WIP: chore(root): new docs docusaurus + swagger ui#331

Draft
alirezakazemeini wants to merge 29 commits intomasterfrom
root/chore/docusaurus-implementation
Draft

WIP: chore(root): new docs docusaurus + swagger ui#331
alirezakazemeini wants to merge 29 commits intomasterfrom
root/chore/docusaurus-implementation

Conversation

@alirezakazemeini
Copy link
Copy Markdown
Collaborator

No description provided.

@alirezakazemeini alirezakazemeini marked this pull request as draft November 20, 2025 10:00
@alirezakazemeini alirezakazemeini changed the title chore(root): new docs docusaurus + swagger ui WIP: chore(root): new docs docusaurus + swagger ui Nov 20, 2025
Copy link
Copy Markdown

@aminlotfi aminlotfi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your efforts @alirezakazemeini ❤️

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest having someone from the SRE team review this workflow.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

.idea/vcs.xml Outdated
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remove all .idea files and add them to .gitignore as well.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remove it.

],
],

themeConfig: {
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@SepidehM mentioned we don’t need all those language tabs and prefer having just 3–4. You can control this via themeConfig, for example:

languageTabs: [
  {
    highlight: "python",
    language: "python",
    logoClass: "python",
  },
  {
    highlight: "javascript",
    language: "nodejs",
    logoClass: "nodejs",
  },
],

Please double-check with @SepidehM which languages she wants.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks a lot! i tried using themeConfig.api and several other methods, but none of them worked. this one does! 😁

package.json Outdated
Comment on lines +21 to +22
"@docusaurus/core": "3.8.1",
"@docusaurus/preset-classic": "3.8.1",
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can update to the latest Docusaurus version:
@docusaurus/core: 3.8.1 → 3.9.2
@docusaurus/preset-classic: 3.8.1 → 3.9.2

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated ✅


const results = searchIndex.filter((entry) => entryMatchesQuery(entry, query))

setSearchResults(results.slice(0, 10))
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: consider defining a constant for the max results. For example, const MAX_RESULTS = 10.

Comment on lines +101 to +103
setSelectedIndex((prev) =>
prev < searchResults.length - 1 ? prev + 1 : prev
)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: setSelectedIndex((prev) => Math.min(prev + 1, searchResults.length - 1))

)
} else if (e.key === 'ArrowUp') {
e.preventDefault()
setSelectedIndex((prev) => (prev > 0 ? prev - 1 : 0))
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: setSelectedIndex((prev) => Math.max(prev - 1, 0))

const resultsRef = useRef<HTMLDivElement>(null)

useEffect(() => {
const handleKeyDown = (event: KeyboardEvent) => {
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: you can extract this into a custom hook. For example, useEscapeKey(onClose).

direction: rtl;
}

.openapi-schema__name {
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@SepidehM raised concerns about the UI spacing. Please fix the incorrect padding/margins and consider using CSS logical properties for automatic RTL/LTR support. For example, padding-inline-start, margin-inline-start, etc. as a more global solution.

@SepidehM SepidehM requested a review from aminlotfi February 2, 2026 15:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants